PATHMac OS 8 and 9 Developer Documentation > Files > Navigation Services >

Programming With Navigation Services 1.1

Navigation Options

The Location pop-up menu button and the Shortcut, Favorites, and Recent bevel buttons, shown in Figure 3 , provide quick navigation tools.

Figure 3 Navigation options


Location Button

The Location pop-up menu displays the current location and provides a familiar way to navigate the file system hierarchy. Figure 4 shows the pop-up menu in its open and closed states.

Figure 4 Location pop-up menu in closed and open states


Shortcuts Button

The Shortcuts bevel button activates a pop-up menu that allows quick navigation to any mounted volume or directly to the desktop. If ejectable volumes are mounted, an Eject command (one for each volume) appears at the bottom of the menu, as shown in Figure 5 .

Figure 5 Shortcuts pop-up menu

Navigation Services 1.1 adds two network connection options to the Shortcuts menu. The Network command displays all available AppleTalk zones in the browser list. The Connect to Server command displays a dialog box that prompts the user to enter a network address for an AppleShare server. The address can be entered as an IP address ("XXX.XXX.XXX.XXX") or as a domain name ("sample.apple.com").

Note

Navigation Services 1.1 supports directly opening a new connection to an AppleShare IP server through the Connect to Server command, but does not support direct connections to AppleTalk servers. Your application should not make any assumptions about what type of connections are available, however, since this may change in future versions of Navigation Services.


Favorites Button

The Favorites bevel button activates a pop-up menu of the user's favorite documents, folders, and volumes, as shown in Figure 6 .

Figure 6 Favorites pop-up menu

The Favorites pop-up menu is divided into three sections. The top section contains two commands:

The second section contains a list of favorite documents set by the user. The third section contains a list of user-set favorite folders, volumes, and AppleTalk zones. These lists are available to all applications that use Navigation Services.

In an Open dialog box, Navigation Services displays favorite files and folders, but in a Save dialog box, only folders are displayed.

In an Open dialog box, the user can add an item to the Favorites menu by using the Add to Favorites command or by dragging the file or folder from the browser list or desktop to the Favorites bevel button. Users can remove items from the list with the Remove From Favorites command.


Recent Button

The Recent bevel button activates a pop-up menu of recently accessed documents, folders, and volumes, as shown in Figure 7 .

Figure 7 Recent pop-up menu

The Recent menu is divided into two sections; the first displays documents and the second displays folders and volumes. In an Open dialog box, Navigation Services displays favorite files and folders, but in a Save dialog box, only folders are displayed. The number of items in each section of the Recent menu will not exceed the number set in the Remember Recently Used Items section of the Apple Menu Options dialog box.

© 1998 Apple Computer, Inc. – (Last Updated 23 Nov 98)